topColor

Type

property

Summary

Specifies the color of a three-D object's raised edge.

Syntax

set the topColor of <object> to {empty | <colorName> | <RGBColor>}

Description

Objects whose threeD property is set to true appear to stick out of or recede into the screen. Use the topColor property to specify the color of the raised edge of the object.

Setting the topColor of an object to empty allows the topColor of the object's owner to show through. Use the effective keyword to find out what color is used for the object, even if its own topColor is empty.

If the object's showBorder property is false, the topColor has no effect.

The setting of the topColor property has different effects, depending on the object type:

• The topColor of a stack determines the topColor of each object in the stack that does not have its own topColor.

• The topColor of a card determines the color of the border on the top and left edges of the card or group, as well as determining the topColor of each object on the card that does not have its own topColor.

• The topColor of a group determines the color of the border on the bottom and right edges of the group, as well as determining the topColor of each object in the group that does not have its own topColor.

• The topColor of a button, player, EPS object, or graphic forms a border on the top and left edges of the object. If the object's threeD property is false, the topColor has no effect.

• The topColor of a field forms a border on the bottom and right edges of the field and (if the field is a scrolling field) the top and left edges of the arrow boxes at the ends of the scrollbar and the bottom and right edges of the scroll area. The field's topColor also determines the color of the top and left edges of any text in the field whose textStyle is set to "threeDBox". If the field's threeD property is false, the field border is not affected.

• The topColor of a scrollbar forms a border on the top and left edges of the arrow boxes at the ends of the scrollbar, and the bottom and right edges of the scroll area.

• The topColor of an audio clip or video clip has no effect.

• The topColor of an image is the fifth color in the image's color palette. (To set the color of the raised edge of an image's border, set the topColor of the card, stack, or group that owns the image.)

If an object's topPattern is set, the pattern is shown instead of the color specified by the topColor.

Examples

set the topColor of last button to 32,32,96

set the topColor of this stack to "white"

set the topColor of scrollbar ID 22 to "#339933"

Related

property: bottomColor, shadowColor, hiliteColor, hiliteBorder, borderColor, topPattern, threeD, colors, backgroundColor, owner, topColor, textStyle

command: group

function: colorNames

glossary: object, property, EPS, audio clip, owner, object type, color palette, keyword, integer, video clip, hexadecimal, color reference

keyword: effective, field, button, scrollbar, player, graphic, card, image

object: image, field, stack

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile